Overview

In event price sets, a price option can have a "participant count". E.g. purchasing a "table for 10" ticket will increment the participant count by 10 despite buying one ticket. This PR adds support for participant counts in WFC.

Before

All tickets purchased count as one participant.

After

A "participant count" field exists This can be a numeric input, Computed Twig, etc.

The "Fee Amount" is not affected by the count. If you want the fee amount to be "per participant", you'll use Twig.

Technical Details

Participant count requires a line item with a non-NULL price_field_value_id). WFC has line items for paid events only. We never populate price_field_value_id.

So:

• We introduce a new field "Participant Count" (in AdminHelp.php and Fields.php).
• We create a hidden price field exclusively for use by WFC events. The Utils.php function returns that price field value, and will create it if it doesn't exist.
• When recording a contribution's line items, we now include the count. We make changes to qty and unit_price to be count-aware (if used). We include the required line_total and price_field_value_id so participant count is calculated correctly.
• When recording events, we check if it's a paid event. If not, we create a line item tied to the participant record.

Comments

When testing, note that API4's "remaining participants" calculated field is inaccurate for multiple reasons. To view an accurate count, call Api3 event.get and return underdocumented value is_full (see screenshot).